home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 021-030 / amok28 / ecces / ecces.dok < prev    next >
Text File  |  1993-11-04  |  7KB  |  142 lines
  1.  
  2.  ****************************************************************************
  3.  
  4.  EcceS Version 1.0 -------- Autor : Norbert Süßdorf -------------- 31.03.1989
  5.  ----------------------------------------------------------------------------
  6.  
  7.  Copyrights : Keine. 
  8.  
  9.  Aber :       EcceS ist Public-domain und darf von jedem kopiert,
  10.               weitergegeben, modifiziert und etc. werden - unter
  11.               Einhaltung folgender Bedingungen :
  12.  
  13.               Die Weitergabe muß kostenlos und immer in Verbindung
  14.               mit diesem Dokument erfolgen. Mein Name darf nicht
  15.               aus dem Programm entfernt werden. Falls jemand EcceS
  16.               modifiziert, muß er seinen Namen im Programm angeben
  17.               und in diesem Dokument auf sich und die vorgenommenen
  18.               Modifikationen hinweisen.
  19.               Für Modifikationen gilt : Nicht am Original-Programm-
  20.               code, sondern nur am ModulaII-Quellcode unter Erstel-
  21.               lung eines eigenen Compilats! (Der Quellcode erscheint
  22.               evtl. auf einer AMOK-Diskette).
  23.  
  24.  Ausnahmen :  Wenn EcceS unsichtbar - ohne Ikone - weitergegeben wird
  25.               (z.B. als Default-Tool für 'ReadMe'-, bzw. 'Lies_Mich'-
  26.               Texte oder zur Verwendung in der 'startup-sequence' - 
  27.               also nur als Mittel zum Zweck), kann auf die Weitergabe
  28.               dieses Dokuments verzichtet werden.
  29.  
  30.  Nutzung :    EcceS darf zwar nicht kommerziell weitergegeben,
  31.               aber Teile davon dürfen in kommerziellen Programmen
  32.               verwendet werden, und EcceS selbst darf auch kommer-
  33.               ziell genutzt werden (z.B. Schaufenster-Werbung). 
  34.               Dafür erhebe ich k e i n e Gebühren.
  35.  
  36.  Eigenschaften und Bedienung :
  37.  
  38.  EcceS liest, über Klick auf die EcceS-Ikone, dann [SHIFT] und Doppelklick
  39.  auf die Ikone der Text-Datei, diese Datei komplett (solange genug Haupt-
  40.  speicher frei ist!) in einen Puffer und gibt den Text zum Lesen auf dem
  41.  Bildschirm aus. EcceS kann auch im 'Info' der Text-Datei als 'Default-Tool'
  42.  eingetragen werden, und wird dann bei Doppelklick auf die Ikone der Text-
  43.  Datei gestartet. EcceS entspricht somit Programmen wie 'More','Less',
  44.  'MuchMore' und ähnlichen. Dabei kann in der Version 1.0 nur seitenweise
  45.  (24 oder 21 Zeilen pro Seite) durch die Datei geblättern werden.
  46.  Sobald die Datei eingelesen ist, wird sie ordnungsgemäß geschlossen und
  47.  steht für andere Zwecke zur Verfügung.
  48.  Über die Taste [Help] kann während des Programmlaufs im Normal-Modus eine
  49.  kurze Bedienungsanleitung abgerufen werden. Die wesentlichen Funktionen
  50.  sind dort beschrieben; deshalb gehe ich hier nicht mehr darauf ein.
  51.  
  52.  EcceS als Text-Slideshow :
  53.  
  54.  EcceS kann auch vom CLI unter Angabe mehrerer Parameter gestartet werden.
  55.  Der erste Parameter muß den Namen der zu öffnenden Text-Datei unter An-
  56.  gabe des Pfadnamens - falls die Datei nicht im selben Verzeichnis liegt
  57.  - beinhalten. Die vier nächsten Parameter können wahlweise angegeben
  58.  werden.
  59.  Der erste dieser nachfolgenden Parameter beeinflußt die Hintergrund-
  60.  farbe der Textausgabe (vier Möglichkeiten).
  61.  Der zweite entscheidet über die Text-Schatten-Kombination (zwölf Mög-
  62.  lichkeiten).
  63.  Der dritte gibt an, ob EcceS normal, als Slideshow mit, oder ohne Ver-
  64.  lassen des Programms gestartet wird (EcceS geht in diesem Fall am Ende
  65.  der Slideshow in den Normal-Modus über). Außerdem entscheidet dieser Pa-
  66.  rameter über die Anzeigedauer pro Seite. Ein negativer Wert führt zum
  67.  autom. Verlassen von EcceS.
  68.  Der vierte Parameter legt die Erscheinungsposition des EcceS-Ausgabe-
  69.  fensters fest (Y-Koordinate von Screen-Oberkante(0) aus). Ein negati-
  70.  ves Vorzeichen schaltet dabei die Schriftgröße Topaz9 ein.
  71.  
  72.  (Beispiel siehe nächste Seite)
  73.  
  74.  Beispiel: EcceS df1:Meine_Nachricht 1 0 -10 -0
  75.                   /   \          /   | |  |    \
  76.               Pfad     Text-Datei    | |  |     Y-Position und Topaz9
  77.                            Papierfarbe |  zehn sec. pro Seite und Ende
  78.                                        Textfarbe
  79.  
  80.  Im Slideshow-Modus können aus dem Programm heraus auch CLI-Befehle
  81.  (oder andere Programme unter Angabe des Pfadnamens, falls sich diese
  82.  nicht im aktuellen Verzeichnis befinden) gestartet werden.
  83.  Zu diesem Zweck muß der CLI-Befehl 'RUN' und natürlich auch der auf-
  84.  zurufende CLI-Befehl im c-Verzeichnis der System-diskette vorhanden
  85.  sein.
  86.  Die Aufrufprozedur dieser Programme wird im Text der Slideshow unter-
  87.  gebracht. Sie muß jeweils in der letzten Zeile der Ausgabeseite - bei
  88.  Topaz8 in den Zeilen 24,48,72 usw., bei Topaz9 in Zeile 21,42,63 usw.
  89.  - stehen und von einem speziellen Zeichen eingeleitet werden.
  90.  Dieses Zeichen erhält man in einem Text-Editor durch Tastenkombination
  91.  [ALT]+[p] (deutsche Tastatur) oder [ALT]+[6] (amerik. Tastatur).
  92.  Es wird in einigen Programmen als Paragraph-Ende-Zeichen verwendet und
  93.  von EcceS grundsätzlich als Zeilenende interpretiert und auch nicht
  94.  auf dem Bildschirm ausgegeben. Deshalb kann ich es hier auch nicht 
  95.  mit EcceS darstellen. Im Text-Editor (z.B. Microemacs) ist dieses
  96. ¶echo "Dieser Text wurde von EcceS ausgegeben."
  97.  Zeichen natürlich sichtbar.
  98.  (Schaut Euch dieses Dokument mit 'Less','More','Muchmore' oder einem
  99.  Text-Editor an. Wenn Ihr dieses Dokument als Text-Slideshow startet
  100.  - in Topaz8 - , habt Ihr auch gleich ein Demo-Beispiel).
  101.  
  102.  Wird in der Aufrufprozedur ein autom.-endendes Programm aufgerufen,
  103.  z.B. der CLI-Befehl 'Echo', dann fährt EcceS erst nach Ende dieses
  104.  Programms mit der Text-Slideshow fort. Nicht autom.-endende Programme
  105.  müssen erst vom Benutzer beendet werden. Um dies zu umgehen, kann man
  106.  Programme auch mit RUN Programmname... als neuen Task starten.
  107.  
  108.  Im Slideshow-Modus sind das Close-Gadget und die Tastatur-Befehle
  109.  nicht aktiviert. Die Slideshow kann also nicht vorzeitig beendet
  110.  werden.
  111.  
  112.  
  113.  WICHTIG : Läuft EcceS als Slideshow (nur vom CLI möglich) als eigener
  114.            Task (RUN EcceS Dateiname...) und werden dabei von dieser
  115.            Slideshow Programme aufgerufen, dann darf das CLI-Fenster
  116.            während der Laufzeit N I C H T geschlossen werden!
  117.            (TASK HELD...)
  118.  
  119.  WARNUNG : Einige CLI-Befehle sind sehr mächtig und können katastrophale
  120.            Folgen haben. Ich bitte daher, keinen Unfug mit EcceS-Slide-
  121.            shows zu treiben. Grundsätzlich übernehme ich keine Haftung
  122.            für Schäden irgendwelcher Art, die sich aus der Anwendung von
  123.            EcceS ergeben.
  124.  
  125.  
  126.  ----------------------------------------------------------------------------
  127.    Hier sollten die Modifikationen und der Name des jeweiligen Autors
  128.    aufgeführt werden :
  129.  
  130.    Autor : Norbert Süßdorf
  131.    
  132.    Modifikation : EcceS Version 1.1
  133.  
  134.    Zusätzliche Möglichkeit den Text auf dem Drucker auszugeben.
  135.    Dazu muß man die [F5]-Taste drücken, worauf ein Requester erscheint.
  136.    Bei positiver Antwort sollte der Drucker bereit und mit Papier
  137.    gefüttert sein. Falls der Text Steuerzeichen enthält (die von EcceS
  138.    ja nicht berücksichtigt werden), werden auch diese an den Drucker
  139.    übermittelt.
  140.  
  141.  ****************************************************************************
  142.